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Notational Conventions 


THIS TYPE Use these keywords, letters, symbols, 
and punctuation verbatim. Upper or 
lowercase is acceptable. 


italics Substitute language elements or 
constructs for true terms. 


[] Optional constructs. 


(i hes Optional constructs that can be repeated 
any number of times. 


L.-J The preceding item may be repeated, 
but each repetition must be separated 
by a comma. 


{ } Alternate constructs. Choose any one 
of the constructs enclosed in the 
braces. 


[*text enclosed*/ Text enclosed is a prose definition of the 
construct. 


When two adjacent items must be concatenated, they 
appear with no space between them. A blank space 
between two items indicates that the two items may be 
separated by one or more blanks. 


Definitions of Common Terms 


Names can be from 1 to 40 characters long 
and must be composed of letters (A-Z). 
digits (0-9), or special characters (?, @, -). 
The first character must be a letter or a 
special character. 


module-name Same as name 
segment-name Same as name. 


pathname A valid ISIS-II filename reference or device 
reference. See next two items for examples 


filename A reference to a disk file. The format is: 


[:Fn:jroot [.ext ] 


Examples: PROG1, Fi:SAMPL1, 
TEST.HEX, 
:F2:SAMPLE.OBJ 


device A reference to a non-disk device. 
Examples: :LP:, :CO:, :TO:. 


value A 16-bit unsigned integer. 


Examples: 1011B, 304Q, 4096D (or just 
4096), OC300H. 


address Same as value. 


RL51 Command Format Summary 
[:Fa:]RLS1 input-list [T0 output-file| [control-list] 


where 


; drive number 


input-list : = 
input-file [module-list\[,...] 


input-file: = 
filename 


RL51 Command Format Summary (Cont’d.) 


module-list : = 
(module-name [,...]) 


output-file : = 
filename 


control-list : = 
control ... 


contro! : = 
listing-control 
linking-control 
locating-control 
configuration-control 
overlay-control 


listing-control_: = 
print 
pagewidth 
map 
symbols 
publics 
lines 
ixref 


print :* 
PRINT [(pathname)] 
NOPRINT 


pagewidth := 
PAGEWIDTH (value) 


map :* 
MAP 
NOMAP 

symbols :* 


SYMBOLS 
NOSYMBOLS 
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publics := 
Weneage | 
NOPUBLICS 


lines :* 
LINES 
NOLINES 
ixref := 


| 1 X RE F[selection-list] 
NOIXREF 


selection-list : = 
( selection-item [,...]) 


selection-item :* 


generated 
libraries 


generated :* 


GENERATED 
NOGENERATED 


libraries :* 


Wtadaccacd 
NOLIBRARIES 


linking-control : = 
NAME (module-name) 
debugsymbols 
debuglines 
debugpublics 


debugsymbols := 


DEBUGSYMBOLS 
NODEBUGSYMBOLS 
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debuglines :* 
DEBUGLINES 
NODEBUGLINES 


debugpublics :* 


DEBUGPUBLICS 
NODEBUGPUBLICS 


locating-control : = 


PRECEDE 

DATA 

BIT 

IDATA (segment [,...]) 
STACK 

XDATA 

CODE 


segment :* 
segment-name [(address)] 


configuration-control : = 
ramsize 


ramsize :* 
RAMSIZE (value) 


overlay-control : = 


OVERLAY[Coverlay-unit [,...])] 
NOOVERLAY 


overlay-unit :* 
ov-module-name calls ov-module-name 


| | ov-module-name :* 


{ module-name \ 


calls :* 


Listing Controls 


Control 


PRINT [(pathname)] 
NOPRINT 
PAGEWIDTH (value) 


MAP 

NOMAP 
SYMBOLS 
NOSYMBOLS 
PUBLICS 
NOPUBLICS 
LINES 


NOLINES 
IXREF [(selection-list)} 


NOIXREF 


Effect 


Sends the listing file to the file or device 
specified by pathname. 


Suppresses the listing file; overrides any 
of the following listing controls. 


Specifies the maximum page width to be 
used, 


Outputs memory map to link summary 
Suppresses memory map. 

Outputs local symbols to symbol table. 
Suppresses local symbols. 

Outputs public symbols to symbol! table. 
Suppresses public symbols. 


Outputs line numbers to symbol table 
(high-level language translators only) 


Suppresses line numbers. 


Appends intermodule cross-reference 
report to print file. 


Suppresses the intermodule cross- 
reference report 


NOTE: The default for any control (except IXREF) is the positive form 
(PRINT, MAP, SYMBOLS, PUBLICS, and LINES). 
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Linking Controls 


Control 

NAME (module-name) Specifies the name of the output 
module. If the NAME control is omitted, 
the output module name defaults to the 
name of the first input module 
processed 

DEBUGSYMBOLS Copies local symbol information to 
output file 

NODEBUGSYMBOLS Suppresses local symbols 

DEBUGPUBLICS Copies public symbol information to 
output file. 

NODEBUGPUBLICS Suppresses public symbols. 

DEBUGLINES Copies line number information (high- 
level language translators only) to output 
file. 

NODEBUGLINES Suppresses line numbers. 


NOTE: For all linking controls except NAME, the default is the positive 
form (DEBUGSYMBOLS, DEBUGPUBLICS, and DEBUGLINES), 


Locating Controls 


Address 
Range 
(Hex) 


Segment Types 


Controt Address Spaco (and Attributes) 


00H-2FH DATA (UNIT-aligned); 


IDATA 


PRECEDE Register banks and bit- 
addressable space in 


on-chip data RAM 


O0H-7FH 
(see note 1) 


Bit-addressable space BIT; DATA; 1DATA 


in on-chip data RAM 


OOH-7FH DATA (UNIT-aligned); 


IDATA 


Directly-addressable 
on-chip data RAM 


QOH-OFFH 
(see note 2) 


Indirectly-addressable IDATA 


on-chip data RAM 


Same as IDATA 


Same as 
IDATA 


0-OFFFFH 
0-OFFFFH 


Same as IDATA (see 
note 3) 


XDATA 


External data RAM 


CODE 


Code memory 
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